Skip to main content
GET
/
api
/
v1
/
offramp
/
ledger
/
status
/
{reference}
Track transaction by reference
curl --request GET \
  --url https://api.dev.monei.cc/api/v1/offramp/ledger/status/{reference} \
  --header 'X-API-KEY: <api-key>'
{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "internalReference": "OFF-A1B2C3D4",
  "provider": "monirates",
  "providerTransactionId": "68ee3a94c05777e37c10b3c1",
  "status": "processing",
  "cryptoAmount": 100,
  "fiatAmount": 145800,
  "exchangeRate": 1458,
  "fromCurrency": "USDT",
  "toCurrency": "NGN",
  "createdAt": "2025-10-14T11:57:08.122Z",
  "updatedAt": "2025-10-14T11:57:09.065Z",
  "expiresAt": "2025-10-14T12:27:08.122Z",
  "providerStatus": "PROCESSING",
  "fees": {
    "providerFee": 0.01,
    "networkFee": 0.0015,
    "serviceFee": 0.005
  },
  "debitPaymentDetails": {
    "paymentMethod": "STABLE_CURRENCY",
    "currency": "USDT",
    "network": "BEP20",
    "walletAddress": "0x5860a46314c08be9fdFBE7fF3ce9604dC59551D1"
  },
  "creditPaymentDetails": {
    "paymentMethod": "BANK_TRANSFER",
    "currency": "NGN",
    "accountName": "John Doe",
    "accountNumber": "0115847370",
    "bankCode": "999240"
  },
  "completedAt": "2025-10-14T12:00:00.000Z"
}

Authorizations

​
X-API-KEY
string
header
required

Path Parameters

​
reference
string
required
Example:

"OFF-A1B2C"

Response

200 - application/json
​
id
string
required

Transaction ID

Example:

"123e4567-e89b-12d3-a456-426614174000"

​
internalReference
string
required

Internal reference number

Example:

"OFF-A1B2C3D4"

​
provider
enum<string>
required

Exchange provider

Available options:
monirates,
bitnob,
paycrest
Example:

"monirates"

​
providerTransactionId
string
required

Provider transaction ID

Example:

"68ee3a94c05777e37c10b3c1"

​
status
enum<string>
required

Current transaction status

Available options:
initiated,
quote_created,
awaiting_deposit,
deposit_received,
pending,
processing,
fiat_sent,
completed,
failed,
cancelled,
refunded
Example:

"processing"

​
cryptoAmount
number
required

Cryptocurrency amount

Example:

100

​
fiatAmount
number
required

Fiat currency amount

Example:

145800

​
exchangeRate
number
required

Exchange rate applied

Example:

1458

​
fromCurrency
string
required

From currency

Example:

"USDT"

​
toCurrency
string
required

To currency

Example:

"NGN"

​
createdAt
string<date-time>
required

Transaction creation timestamp

Example:

"2025-10-14T11:57:08.122Z"

​
updatedAt
string<date-time>
required

Transaction last update timestamp

Example:

"2025-10-14T11:57:09.065Z"

​
expiresAt
string<date-time>
required

Transaction expiry timestamp

Example:

"2025-10-14T12:27:08.122Z"

​
providerStatus
string
required

Provider status

Example:

"PROCESSING"

​
fees
object
required

Transaction fees

Example:
{
  "providerFee": 0.01,
  "networkFee": 0.0015,
  "serviceFee": 0.005
}
​
debitPaymentDetails
object
required

Debit payment details

Example:
{
  "paymentMethod": "STABLE_CURRENCY",
  "currency": "USDT",
  "network": "BEP20",
  "walletAddress": "0x5860a46314c08be9fdFBE7fF3ce9604dC59551D1"
}
​
creditPaymentDetails
object
required

Credit payment details

Example:
{
  "paymentMethod": "BANK_TRANSFER",
  "currency": "NGN",
  "accountName": "John Doe",
  "accountNumber": "0115847370",
  "bankCode": "999240"
}
​
completedAt
string<date-time> | null
required

Transaction completion timestamp

Example:

"2025-10-14T12:00:00.000Z"